Currency Exchange Rate API (SOAP)
Request Access from Exchange
Step 1 - Preparation and ServiceNow Request (first 3 blocks in the overview)
Before submitting any request, we kindly ask you to review our “[Request Access][1]” gSite page as well as our “[API data dictionary][2]”. You will need to prepare your request by identifying if you need access to this API or if any other pattern would fit. If the API is identified as the solution to get P&C workers data for your system, you will need to collect the data groups from the “[API data dictionary][3]” and the countries you need.
Once the process is reviewed and your data groups are defined, you can submit your request via the “[People & Culture Data Access][4]” form. The process to request access to the Worker API should start from the request form available in the ServiceNow End User Portal.
Step 2 - Roche Generic Account and Cloud Certificate
This is the time to create your Roche Generic Account and generate your Roche Cloud Certificate for API authentication purpose. Please follow the 2 steps below:
- Create your [Roche generic account (link to the process)][5]
- Generate a cloud certificate from your generic account, please follow the instructions [from this article (link to the process)][6]
Please note that we are asking for 2 different generic accounts and certificates: one for NON-PROD environments (DEV, TEST) and one for PROD environments (STAGE, PROD). If you already have generic accounts and certificates from previous projects, you can reuse them (as far as you have 2 different ones: one for NON-PROD and one for PROD).
Additional note: we are asking to start this process before submitting your request in Anypoint Exchange as this is a separate process driven by identity management. This request can take some time, starting it early enough can help speeding up the process.
Step 3 - Mulesoft Access request (requires step 1 to be completed) - Please read carefully each of the points listed below
Please follow the steps below to submit your request in Anypoint Exchange:
- In the top right hand corner of this page click to "Request access"
- Select the desired environment to connect (DEV, TEST or PROD - a specific agreement with the FGH team will be required for access to the STAGE environment).
- Select "Select application" and choose to "Create a new application". Important notice: we will be asking you to create 2 specific applications - one for non-prod environments (DEV, TEST) and one for PRE-PROD and PROD environments (STAGE and PROD). Example: fgh-workday-non-prod, fgh-workday-prod. Please follow this naming convention: "{department short code}-{application name}-{environment (NON-PROD or PROD)}"
- Enter details for your consuming application. The more information provided here, the easier the API Owner will be able to approve your request. Once completed click "Create".
- Select the desired "SLA Tier"
- Check your client id under My Applications and store it for further use.
Note:all requests that did not start from the Service Now request form (from step 1) will be rejected.
Step 4 - Prepare and submit your request template - needed for Access Control configuration
After submitting your Anypoint Exchange request (from Step 3), please send an email to the FGH Data Enablement team (hr-it.data_enablement@roche.com, priscilla.lovato@roche.com, magdalena.piatkowska@contractors.roche.com) attaching the API Access Request document. [A template is available here][7], please copy it and edit the copy.
The mandatory fields in this template are:
- The Service Now Request number
- The list of required data groups and countries
- Your The MuleSoft application name (from Step 3) and the SSL Client Certification Serial number (generated in Step 2).
[View how to find the SSL Certificate Serial Number here][8]
Note:all requests that did not start from the Service Now request form (from step 1) will be rejected.
Step 5 - ServiceNow Request to GIS Operations Team
The step 4 is needed as a pre-requisite for this request. This is the step where Data Groups and Countries will be configured for your application in Mulesoft.
Please create a “[Pharma MuleSoft Generic Platform/ Consultancy Request][9]” to the GIS Operations Team. In this request you need to:
- Mention the request number from your HR Data Access Request (from Step 1, example: RITM1272341)
- Attach the document with configuration details (from Step 4)
Additional questions can be sent to gis_it.mulesoft_operations@roche.com.
Additional note: Once the request is submitted, a change of the configuration file of fg-access-control-sys application will be made in order to configure your access to data groups and countries. A redeployment of this api will also be done by GIS Operations Team to activate your access. Additionally, the GIS Operation Team will configure SSL Policy in API Manager to map your Mulesoft Application client app’s client id with Serial Number of certificate. Once done the GIS Operation team will send you a confirmation.